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PREFACE 



This publication contains information for 
both the beginning and the advanced VM/370 
user. The first four sections are intended 
for the new user and the last section, 
including a reference card, is intended for 
the experienced user. 



The first two sections, "What You Should 
Know Before You Start Using the VM/370 
System" and "VM/370 System Information", 
are designed to help the new VM/370 user 
become acquainted with the system. These 
sections contain information for getting 
started and setting up a virtual machine. 
The third section, "Using CMS", discusses 
using the CMS facilities as a file creation 
and maintenance tool. 



The fourth section, "Functions of VM/370 
Commands", summarizes the commands by their 
intended use (for example, debugging and 
file maintenance commands) • A new VM/370 
user should find these function summaries a 
helpful and time-saving tool. 



The last section, "Summary of VM/370 
Commands", is a reference card intended for 
the experienced VM/370 user. The reference 
card contains a brief syntactic description 
and explanation of each VM/370 command. 



Information in this publication (if any) 
about the following is for planning 
purposes only: 



• The CMS Batch Facility, 

• The IBM System/370 Models 165 II and 
168. 



The new user should use some of the VM/370 
publications in conjunction with the first 
four sections of this Quick Reference 
Guide. 



Prerequisite Publications 



IBM Virtual Machine Facility/370: 
Introduction, GC2 0-1800 

IBM Virtual Machine Facility/370; 
Command Language Use r's Guide, 
GC20-180U 

IBM Virtual Machine Facility/370; 
Mil Guide, GC20-1805 



Coreguisite Publications 



IBM Virtual Machine Facility/370: 
Assembler Programmer's Guide, 
GC20-1802 

IBM Virtual Machine Facility/370: 
System Messages , GC20-180 8 

IBM Virtual Machine Facility/370; 
Terminal User's Guide, GC20-1810 



The experienced user should use the 
following publications in conjunction with 
the "Summary of VH/370 Commands" section. 



Corecfuisite Publications 



IBM Virtual Machine Facility/370: 
Planning and System Generation Guide , 
GC20-1801 

IBM Virtual Machine Facility/370: 
BASIC Language Reference Manual, 
GC20-1803 

IBM Virtual Machine Facility/370: 
Command Language User '_s Guid e, 
GC20-180U 

IBM Virtual Machine Facility/370: 
EDIT Guide, GC20-1805 

IBM Virtual Machine Facility/370: 
Programmer 1 s Guide to Debugging, 
GC20-1807 
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WHAT YOU SHOULD KNOW BEFORE YOU START USING 
THE VM/370 SYSTEM 



The environment of the IBM Virtual Machine 
Facility/370 (VM/370) is one of virtual 
machines, A virtual machine is a functional 
simulation of a real computer and its I/O 
devices, VM/370 builds and maintains, for 
each user, a virtual System/370 machine 
from a predefined configuration. 

The virtual machine configuration includes 
components corresponding to a real 
System/370: a virtual operator's console, 
virtual storage, a virtual CPU, and virtual 
channels and I/O devices. However, since 
the virtual machines are simulated, their 
configurations may differ from each other 
and from the real machine. For example, the 
real machine may have 512K bytes of real 
storage and eight real disk drives, while a 
virtual machine may have 768K bytes of 
virtual storage and two virtual disk 
drives. 

Regardless of the configuration, you 
control your virtual machine from your 
terminal, which is, effectively, your 
operator's console. The work to be done by 
the virtual machine is scheduled and 
controlled by an operating system that can 
run under VM/370, An example of a virtual 
machine operating system is the 
Conversational Monitor System (CMS) , which 
was specifically designed to run in a 
virtual machine under control of VM/370. 
CMS provides, at a remote terminal, a full 
range of conversational capabilities: 
creation and management of files; 
compilation, testing, and execution of 
problem programs; and execution of 
application programs. The "Using CMS" 
section of this Quick Reference Guide 



Using the VM/370 System 



describes how you can use a CMS virtual 
machine under VM/370. 

Before you can start using VM/370 you must 
have: 

• A user identification and password, 

• A virtual machine defined for your use. 
(The virtual machine definition should 

include all the devices you will need. 
For example, a console, spooled unit 
record devices, and disk space,) 

• Properly formatted disk space, (If you 
wish, you may format your disk space 
after you log on,) 



GETTING STARTED (IDENTIFICATION AND 
PASSWORD) 



Before you can use VM/370, you must be 
assigned: 

• A user identification (userid) that 
identifies you to the system, and 

• A password that is checked when you log 
in, 

(Examples in this book use a userid of 
PUBS,) Assignment of a userid and password 
is normally handled (and approved) by the 
VM/370 system operations manager. 

Once you have your userid and password, you 
can communicate with the VM/370 system from 
a remote terminal such as an IBM 2741 
Communications Terminal or IBM 1050 Data 
Communication System (or equivalent) , 
Depending on your terminal installation, 
you either dial the central VM/370 
computer, or are connected directly. Refer 
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to the IBM Virtual Machine Facility/370; 
Terminal User's Guide, GC20-1810, for a 
description of the communication procedures 
for each type of terminal. 



VIR TUAL MACHINE CONFIGURATION 



When you have a virtual machine defined for 
you, an entry is made in the Control 
Program directory. The systems operation 
group usually sets up your directory for 
you. This directory lists the devices and 
device addresses available to your virtual 
machine. The following is an example of a 
typical CMS virtual machine configuration. 
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FORMATTING DISK SPACE 



All disk space must be formatted for use 
with CMS. The systems operations group 
usually makes sure your disk space is 
formatted. The CMS Format program is 
executed under CMS via the FORMAT command. 
There is an example of the use of the CMS 
FORMAT command in the "Using CMS" section 
of this manual. 
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VM/370 SYSTEM INFORMATION 



TYPING CONVENTIONS 



Because certain special characters can be 
assigned logical editing functions to enter 
input data via VM/370 terminals, the 
following typing conventions should be 
observed. Input data may be entered in 
either upper or lower case. The examples in 
this book show the lines you might enter in 
shading. System responses may be in upper 
or lower case, 

• Character Delete symbol (S) : 

The character delete symbol deletes the 
preceding character in the input line. 
A string of "n" character delete symbols 
delete the preceding "n" characters in 
the input line and itself. 

• Line Delete symbol (£) : 

The line delete symbol deletes all 
characters in the current logical line 
and itself. A line delete symbol cannot 
be deleted by a character delete symbol. 

• Line End symbol (#) : 

The line end symbol indicates the end of 
a logical input line. Use of this 
character permits more than one logical 
input line to be entered in the same 
real input string. 

• Logical Escape symbol (") : 

The logical escape symbol causes the 
character following it to be interpreted 
as a data character (that is r ignored as 
an input line editing character) • This 
allows any of the line editing 
characters to be interpreted literally. 
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For example, consider how the following 
line must be entered into the system: 

1 gross #2 pencils 3 920 per dozen 

Under the VM/370 input conventions, this 
line could not be entered as shown, 
since it would be affected by the #, 3, 
and line editing symbols. For example, 
the # symbol would end the line. 
However, the line is correctly 
interpreted if entered as follows: 

1 gross »#2 pencils "3 92"* per dozen 

The logical escape characters (") are 
not put in the file. 

Line Length: 

For CP console functions and CMS 
commands an input line may be up to 130 
characters long (including the carriage 
return character) . Any line longer than 
130 characters, including blanks, 
backspaces, underscores, the line 
editing characters, and the tab 
character, is truncated to 130 
characters. 

Line Termination: 

An input data line from an IBM 2741 
Communications Terminal is transmitted 
to the computer by pressing the Return 
key. Other terminals have similar line 
termination keys. 

Note: For some terminals, such as the 
IBM 1050, you have to press an Alternate 
Coding key and some other 
multiple-function key at the same time. 
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TERMINAL OPERATING PROCEDURES 



Refer to the IBM Vir tua l Machine 
Facility/370: Terminal User's Guide, 
GC20-1810, for a description of the various 
terminal operating procedures. 



LOGGING ON 

When you establish communication with the 
VM/370 computer, the system sends the 2741 
terminal one of these messages: 

vm/370 online xxxxxx xxxxxx 

— or — 

xxxxxx xxxxxx vm/370 online 

The top line is typed if the terminal is a 
2741 equipped with a PTTC/EBCD character 
set. The bottom line is typed if the 2741 
terminal has a standard Selectric (or 
Correspondence) character set. In either 
case, the 'xxxxxx xxxxxx 1 portion of the 
message consists of meaningless characters, 
and should be ignored. 

Press the Attention (ATTN) key (or 
equivalent) once to unlock the terminal 
keyboard, and identify yourself by entering 
your user identification (userid) as 
follows : 

login pubs 

Then press the Return key. If the userid 
entered is not found in the CP directory, 
the message 

DMKLOG053E userid NOT IN CP DIRECTORY 
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types at the terminal, and you can try to 
enter another userid. 

If the userid entered is found in the CP 
directory, the VH/370 system responds with: 

ENTER PASSWORD: 

At this point, you should type in your 
password, followed by a carriage return 
(press the Return key) • If your terminal 
does not inhibit printing of the password, 
you can press the Return key (or 
eguivalent) to reguest VH/370 to print a 
mask string, as follows: 

00888882 

The system then waits for you to type in 
your password over this mask. If the 
password entered is incorrect, the message 

DMKLOG050E PASSWORD INCORRECT 

types at the terminal. You must start the 
login procedure from the beginning by 
entering your userid again. If you do not 
do this, the message: 

restart xxxxxxx 

— or — 

xxxxxxx restart 

types at the terminal. The top line is what 
you would see at a non-correspondence 
terminal and the bottom line is what you 
would see at a correspondence terminal. You 
must start the login process from the 
beginning. 

If the userid and password entered are 
valid, but someone else has already logged 
on with this userid, the VM/370 system 
issues the message: 
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DMKLOG054E ALREADY LOGGED ON LINE nnn 

where nnn indicates the line on which the 
user is logged. If you want to find out why 
the userid you just entered is in use, 
issue the MSG command to send a message to 
the operator or to the other user. You 
should either log on with another userid or 
try again later. 

Once you have successfully logged on, the 
VM/370 system replies with a log message, 
such as: 

LOGON AT 11:24:35 EST THURSDAY mm/dd/yy 

A logon message from the VM/370 operator 
(if any) also prints at this time. 

Once you have successfully logged on the 
VM/370 system, you can start using the 
virtual machine that you have set up for 
your userid. 



LOGGING OFF 

When you are finished using the system and 
want to end your terminal session, you do 
so by logging out from the VM/370 Control 
Program (CP) . Even if you are in CMS mode, 
you need only type the command: 

logout 

and press the Return key. The system 
responds with: 

CONNECT= 00:11:43 VIRTCPU= 000:05.21 

TOTCPU= 000:21.03 
LOGOFF AT 11:34:44 EST THURSDAY 11/30/72 

and the connection with the VM/370 system 
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is terminated. The connect time is in 
hours, minutes, and seconds. The virtual 
CPU and total CPU times are in minutes, 
seconds, and hundredths of a second. When 
the logout procedure is completed, you can 
turn the terminal power off. Or, you may 
log out by turning the terminal power off. 



Note: If you had logged in on a dialed 
line, you could specify that the 
communication line be left connected, by 
issuing 

logout hold 

When you issue LOGOUT HOLD, you do not have 
to dial the line before logging on again. 



VM437 ENVIRONMENT 



Each input line typed at the terminal by a 
user is transmitted to the VM/370 system, 
where it is processed (examined, and 
accepted or rejected) by a given routine. 
The portion of VM/370 that has control at 
the time a particular input line is entered 
determines which routine processes the 
input. Each portion of the VM/370 system 
which can accept input constitutes a unigue 
environment, and only a subset of all 
possible input is acceptable to any given 
environment. Figure 1 shows the 
environments of the VM/370 system and shows 
how each environment is entered. 



There are three input-processing 
environments: 

« Control Program (CP environment) 
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© Central CMS service routines (CMS 
command environment) 

© CMS command environments (DEBUG r EDIT, 
or a user-written command) 

Input lines that are acceptable to the CP 
and CMS environments are referred to as 
commands. 



Certain CMS commands cause CMS 
subenvironments to be entered. Examples of 
these are the DEBUG and EDIT commands. 
Lines acceptable to the environments of 
these commands are referred to as 
"subcommands, " or merely "input," depending 
on the particular mode which is entered 
when the command is issued. 

If the EDIT command is entered for a file 
that already exists, the EDIT environment 
is entered, allowing the contents of the 
existing file to be examined, added to, 
deleted, changed, or rearranged. You may 
cause the input environment to be entered 
so that you can add to the existing file. 

The CMS EDIT subenvironraent can exit to 
another subenvironment called Input Mode. 
If an EDIT command is issued for a file 
that does not currently exist, the EDIT 
environment is entered, and you may cause 
the INPUT environment to be entered so that 
you may directly create a file on disk, 
thus eliminating the keypunch step. In 
INPUT mode lines of data typed at the 
terminal become a part of the file being 
created. Because no check is made to 
determine the acceptability of input to 
this environment, lines which are keyed in 
are termed "input." 
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The ECHO environment is entered when the CP 
command ECHO is keyed in. All data lines 
entered in the ECHO environment are 
transmitted unchanged back to the terminal 
from which they were received. 



Press the RETURN key (or its equivalent) 
with no characters entered, to determine 
which environment you are in. 



You can take various actions to cause 
control to pass from one environment to 
another. By pressing the Attention key (or 
its equivalent) twice, quickly, you can 
always transfer control to the CP 
environment from any of the other 
environments. These actions are discussed 
throughout the IBM VH/370: Command Language 
User's Guide, GC20-1804. 
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USING CMS 



Before you can use CMS, you must do the 
following: 



Log on with a valid user identification 
and password. The user identification 
should have a directory entry with the 
devices needed for a CMS user, 

IPL the CMS system by specifying the 
name of the CMS system or the device 
address of the CMS system disk. 

Have disk space available that is 
formatted for use by CMS. 



The Logging On procedure is discussed in 
the "VM/370 System Information' 1 section. 
The IPL and disk formatting procedures are 
described in the following section. 



HOW TO IPL CMS 



After you have logged on the VM/370 system, 
you can IPL an operating system. The 
format of the CP IPL command is 



I Ipl I { r -i } I 

| | { vaddr [cylno] JCLear | } | 

| | { systemname 1 NOCLear | } | 

I I { L J } I 

i i 
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where: 

vaddr specifies the virtual address 
(ecu) of the device which 
contains the nucleus of the 
system to be loaded, 

cylno if this operand is specified, 
CP loads the IPL data from the 
specified virtual cylinder 
instead of from the default, 
which is virtual cylinder zero, 

systemname specifies that a copy of the 
named system has been 
previously saved by using the 
CP SAVESYS command, and is to 
be brought into virtual storage 
and given control. 

CLEAR specifies that the virtual 
storage space is to be cleared 
to binary zeros before the 
system is loaded, 

NOCLEAR specifies that the virtual 
storage space is not to be 
cleared to binary zeros before 
the system is loaded. 



Assume that CMS is the systemname of your 
CMS operating system and that 190 is the 
CMS system disk. You can IPL this CMS 
system with either of the following 
commands: 

ipl cms 
ipl 190 



FORMATTING YOUR MINIDISK SPACE 



Before you can use CMS in your virtual 
machine, you must have disk space which has 
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been formatted for use by CMS, Usually the 
system operator provides formatted disk 
space for a new user. However, you can 
format your own disk space. This formatting 
procedure is performed only when new disk 
space is being initialized for your virtual 
machine; it should not be done each time 
you log on to the system. Formatting a disk 
destroys the contents of that disk. 

The disk space for userid PUBS is defined 
in the CP directory as minidisk 191, This 
virtual disk space is the PUBS A-disk (or 
primary user disk) , If you attempt to use 
CMS before formatting your A-disk, an error 
message is issued. For example, assume that 
you (with userid PUBS) have logged on and 
now want to IPL CMS in your virtual 
machine, but your A-disk (virtual address 
191) was never formatted. The terminal 
sheet would look like this: 

i pi eras 

CMS, -VERSION 1,0 mm/dd/yy 

(Press the Return key.) 

Y (19E) R/O. 

DMSACC112S »A (191) • DEVICE ERROR. 

R; T=0. 01/0,07 11:25:17 



The "Y (19E) R/0." message tells you that 
the CMS system you just loaded (via IPL) 
has a Y-disk at address 19E which is a 
read-only extension of the system disk 
(S-disk) . 

The "DEVICE ERROR" message indicates that 
your A-disk (in this example, 191) was not 
correctly formatted prior to use. 

To execute the CMS Format program, you must 
type: 

format 191 a 
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where 191 indicates the virtual disk 
address r and "a" indicates that it is the 
A-disk. The Format program then issues 
prompting messages to which you must reply: 

DMSFOR603R FORMAT WILL ERASE ALL FILES 
ON DISK • A (191) • . DO YOU WISH TO 
CONTINUE? (YES|NO) : 

yes 

DMSFOR605R ENTER DISK LABEL: 

pubsOl 

FORMATTING DISK , A«. 

•3« CYLINDERS FORMATTED ON «A(191)«. 

R; T=0. 15/1,60 11:26:03 

If any files existed r they are erased. The 
disk space, that contains 3 cylinders, is 
labeled PUBSOL When your PUBS A-disk is 
formatted and the CMS virtual machine is 
operating, you can use CMS to do some 
further setup work. 

If you know your disk is not formatted at 
the time you IPL r enter the commands: 

ipl cas 4 
access (nodislt 

before pressing the Return key. The error 
message, DMKACC112S, will not type. You 
should then issue the command 

format 191 a 

to format your A-disk. 



WRITING A PROFILE EXEC 



Although you can use CMS without a PROFILE 
EXEC, it is often convenient to use one. 
The PROFILE EXEC is a special EXEC 
procedure that is executed as the first 
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command after you IPL CMS, If you want to 
use the System Assembler to assemble 
programs under CMS, it is a good idea to 
include the CMS and OS macro library in 
your PROFILE EXEC definition. You can do 
this by putting the appropriate GLOBAL 
command in your PROFILE EXEC. Other 
additions for your PROFILE EXEC might be: 

• The short form of the "Ready" message 

o A blip character of "*" to indicate 
seconds of virtual CPU time. 

You create your PROFILE EXEC by using the 
facilities of the CMS EDIT command. The 
EDIT command is fully described in the IBM 
Visual Mchine Facility/370 : EDIT Guide , 
GC20-1805. Only the EDIT subcommands used 
to create your PROFILE EXEC are included 
here. Your PROFILE EXEC for userid PUBS may 
be created by issuing the EDIT command with 
the filename and filetype of "PROFILE 
EXEC". The Edit program will not find the 
file you specified and will return the 
message "NEW FILE" and enter the edit mode. 
You should type "input". When the edit 
program responds with "INPUT:", you can 
start entering the statements of your 
PROFILE EXEC file. Refer to the Edit Guide 
for a description of these subcommands. 
The entire terminal listing would appear as 
follows: 

edit profile exec 

NEW FILE: 
EDIT: 

input 

INPUT: 

^control off 

set rdymsg smsg 

global maclib cmslib osmacro 

set blip * (1) 

(Press the Return key to leave INPUT mode.) 
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EDIT: 

file 

R; T=0.21/0.84 11:31:37 

Now that your PROFILE EXEC has been created 
and filed r you can verify that it contains 
the desired commands by requesting a 
typeout of it at the terminal: 

type profile exec 

SCONTROL OFF 

SET RDYMSG SMSG 

GLOBAL MACLIB CMSLIB OSMACRO 

SET BLIP * (1) 

R; T=0. 12/0.58 11:32:58 



Note that the PROFILE EXEC does not execute 
immediately (the "Ready" message is still 
the long message) • The PROFILE EXEC is not 
executed until the next time you issue IPL 
CMS or the next time you type "profile" 
during your terminal session. 



EXAMPLE OF CMS PROGRAM DEVELOPMENT 
FACILITIES 



This section illustrates several CMS 
functions that are useful in creating and 
manipulating CMS files. In addition, the 
flow of the primary example shows how CMS 
can be used to control program execution. 

First IPL CMS. Note that, if you have 
followed the preceding instructions, the 
disk space is already formatted and no 
error message appears. Also, the short form 
of the Ready message types because your 
PROFILE EXEC file is in effect. 
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CREATING AN ASSEMBLER LANGUAGE SOURCE FILE 



The program used as an illustration in this 
section is an Assembler Language program 
that reads data from one CMS file and 
writes it to another CMS file. After you 
have logged on the system and issued IPL 
CMS, you can create the program using the 
CMS Edit facility. 
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The Editor did not find a file with the 
filename and filetype of MANIP ASSEMBLE r so 
it created the file for you. You then 
issue INPUT and enter your program. You 
must issue the "FILE" subcommand in order 
to save your program. 

Note that this program uses several CMS 
macros; when it is assembled, this program 
will require the CMS macro library. 
However, your PROFILE EXEC (for the PUBS 
user) has specified that the CMS macros be 
included; no further action is necessary to 
include the CMS macros. 

The Load Address (LA) instruction following 
EOF is inserted only for testing; it will 
be deleted when the function has been 
tested. 



ASSEMBLING A SOURCE FILE 



To assemble the MANIP program, you enter 
the "ASSEMBLE MANIP" command, then wait for 
the System Assembler to complete 
processing: 

assemble manip 

ASSEMBLER (F) DONE 



MAN00331 B ERRT 

IEU024 NEAR OPERAND COLUMN 1 — UNDEFINED SYMBOL 

1 STATEMENT FLAGGED IN THIS ASSEMBLY 
8 WAS HIGHEST SEVERITY CODE 
R (00008) ; 



Each asterisk (*) on the second line 
indicates 2 seconds of virtual CPU time. 
The message IEU024 indicates there is an 
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error in your program. The line in your 
program containing the error has a sequence 
number of HAN00331. Print ycur listing 
file to find this line. 

At this point, there are 3 files associated 
with your program. First, the file, HANIP 
ASSEMBLE, contains the source statements of 
your program. This file was the input used 
by the Assembler Language program. The 
output from the System Assembler is 2 
permanent files. One of these files, HANIP 
TEXT, contains the object module. The 
other file, HANIP LISTING, contains a 
listing of the source statements, assembled 
machine code, and other associated 
information based on the options selected 
on the ASSEMBLE command. 



Correcting Errors 

Since the Assembler has detected an error 
in the source code, you must correct the 
error before attempting to execute the 
program. Just as you used the Editor to 
create the Assembler file, you also use the 
Editor to change or correct this Assembler 
file. When you issue the EDIT HANIP 
ASSEMBLE command this time, the Editor 
finds your file and enters the Edit mode. 
Then issue the LOCATE subcommand to find 
the line in error. Issue the CHANGE 
subcommand to correct the error and then 
issue FILE to save the corrected program. 
The terminal sheet would look as follows: 

edit manip assemble 

EDIT: 

locate /errt/ 

B ERRT 
change /errt/erret/ 

B ERRET 

file 

sr ""* 
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Now that the error has been corrected, you 
can assemble the file again: 

asseable manip 

ASSEMBLER (F) DONE 



NO STATEMENTS FLAGGED IN THIS ASSEMBLY 

R; 

This time, the program assembled without 
any assembler-detected errors. The TEXT and 
LISTING files from the previous assembly 
are erased automatically and replaced by 
the new ones from the current assembly. 



CREATING A LOAD MODULE 



You can now create a load module from the 

TEXT file that was created by the 

Assembler. The resulting MODULE file can 
then be executed. 



gensoa matti? 



Now, a fourth file, MANIP MODULE, exists. 
This file is in executable form. 



Testing and Correcting a Pro gram 



Once the MODULE file has been created, you 
can begin testing. To execute the MANIP 
MODULE file issue the command name, MANIP, 
plus the file identifiers for the input and ( 
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output files. The input file (MANIP 
ASSEMBLE A1) is to be copied and the 
resulting file is to be called MANIP1 
ASSEMBLE A1. The first test should take the 
branch on the FSREAD error. The following 
error message appears on the terminal: 

iaanip manip assemble a1 manipl assemble a1 
ERROR CODE 7 IN READING FILE. 
R (00001) ; 

You should then use the Editor to correct 
the program so that this branch is no 
longer taken. 

edit manip assemble 

EDIT: 

find eof 

EOF EQU * 
next 

LA 15,7 TEST CODE FOR READ ERROR 
delete 
file 
R; 

After the corrected version of the program 
is filed, assemble and execute the program 
again. 

assemble manip 

ASSEMBLER (F) DONE 



NO STATEMENTS FLAGGED IN THIS ASSEMBLY 

R; 

load manip 
R; 

geamod manip 
R; 

Now that the testing statement has been 
deleted, and a new MODULE file created, 
further testing of the program can begin. 
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First, attempt to copy a file that does not 
exist. The file is not found. 

manip filel assemble a1 file2 assemble a 1 

FILE NOT FOUND 
R (00001) ; 

Then, attempt to copy a file to itself. 
Your program is not equipped to do this; an 
error occurs* 

manip manip assemble a1 manip assemble at 
ERROR CODE 9 IN WRITING FILE. 
R (00001) ; 

Finally, create a new file (MANIP1) from 
your MANIP file. 

manip manip assemble a1 manipl assemble at 

R ; 



ERASING UNWANTED FILES 



Once testing is complete, type the first 
few lines of file MANIP1 to make sure that 
MANIP was copied correctly, then delete the 
MANIP1 file: 

type manipl assemble 1 5 

MANIP CSECT 

PRINT NOGEN 

SAVE (14,12),,* 

BALR 12,0 

USING *,12 ESTABLISH ADDRESSABILITY 

R; 

erase manipl assemble 

R: 
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The LISTFILE command can then be issued to 
make sure the file was erased: 

listfile * assemble 
MANIP ASSEMBLE A1 

R; 



PRINTING, PUNCHING, AND READING FILES 



PRINTING 



When you want to print your program 
listing, you should first check the output 
status of your virtual printer by entering: 

query OOe 

PRT OOE CLS A COPY 01 

R; 

Since output class A is acceptable for 
program listings r print the LISTING file: 

print manip listing 
R; 

You can also print the LISTING file by 
specifying the PRINT option when you issue 
the ASSEMBLE command. Once the LISTING file 
is printed, it can be erased. In addition, 
you may want to erase the TEXT file from 
which the MODULE file was generated: 

erase manip listing 

W """"" 

erase manip text 
R; 
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PUNCHING 



If other users want to use your MANIP 
program r send it to them by changing the 
destination for your virtual punch r then 
punch the MANIP TEXT file. Use the CMS 
COPYFILE or MOVEFILE commands to transfer 
the MANIP MODULE file to another user. For 
example, suppose the user PAYROLL wanted to 
use the MANIP program. You could send 
PAYROLL a copy of the TEXT file by 
entering: 

spool OOd to payroll 

R; 

punch inanip text 

PUN FILE 029 TO PAYROLL 

R; 



READING 



When the user PAYROLL logs on the VM/370 
system, the following message will type 
during the login procedure: 

FILES: 001 RDR r NO PRT, NO PUN 

To read in this file, the PAYROLL user must 
IPL CMS and issue the command: 

read * 

:READ MANIP TEXT A1 PUBS mm/dd/yy 13:29:03 

R; 

Note, however, that the PAYROLL user can 
decide whether or not he wants the file 
before he reads it by invoking the command: 

query reader all 

FILE CLS RECDS ORIGIN DATE TIME NAME , ^YPE 
029 A 00051 PUBS 11/30/72 13:29:03 MANIP iIXT 
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J 



If the PAYROLL user does not want the file, 
he can purge it from his reader, as 
follows: 

purge reader (or purge reader 029) 
0001 FILE PURGED 

The Conversational Monitor System (CHS) can 
be used for many other purposes. Those 
functions illustrated in the previous 
discussion are intended to help the novice 
VM/370 user become acquainted with the 
system and its capabilities. Once you have 
become familiar with these commands and 
functions, you will have a sound base upon 
which to build a more thorough 
understanding of the VM/370 system. 

The next section of the Quick Guide is a 
brief summary of the functions that can be 
performed by issuing a CP or CMS command. 
The last section of this Quick Guide 
briefly describes the function of each 
VM/370 command and presents its syntactic 
illustration. Experienced users may find 
the functional and command summaries a 
useful supplement to the more detailed 
information contained in the IBM Virtual 
Machine Facility/370: Command Language 
User's Guide, Order No. GC20-1804. 



FUNCTIONS OF VM^/370 COMMANDS 



Figures 2 through 10 present a functional 
summary of commands available in the VM/370 
system. 
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Begin terminal session (identify 
user to VM/370 system) , 

End terminal session. 

Communicate with other VM/370 users 
and with the system operator. 

Connect a terminal to a multiaccess 
virtual machine. 

Disconnect a user's terminal from a 
virtual machine. 

Test terminal hardware. 

Control terminal input and output, 

• Indicate if accounting data is to be 



Command 



LOGIN 

LOGOUT 
MSG 

DIAL 

DISCONN 

ECHO 

SET 



ACNT 



| Type 
CP 

CP 
CP 

CP 

CP 

CP 

CP 
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received at the terminal, 
o Indicate if messages from other users 
are to be received at the terminal, 

o Control line editing functions, 
• Control format of messages received at 
the terminal. 

© Get information about terminal control 
parameters. 

© Specify method of password entry. 

© Specify use of additional translation 

tables, 
o Specify terminal line size. 
© Specify ATTN key handling procedures. 
© Specify that ATTN key will not stop the 

virtual machine. 



| SET 
| SET 


MSG 
HNG 


CP | 
CP | 


| SET 
| SET 
| SET 


LINEDIT 
REDType 
EMSG 


CP | 
CMS | 
CP | 


| QUERY 


TERMINAL 


CP | 


| TERMINAL 
| TERMINAL 


MASK 
APL 


CP | 
CP | 


| TERMINAL 
| TERMINAL 
| SET 


LINESIZE 

ATTN 
RUN 


CP | 
CP | 
CP | 
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Function 



Command 



© Specify characters to indicate CPU 

time interval reporting, 
o Specify format of CMS READY message, 
o Indicate character translations to be 



-I 

| SET 

I 

| SET 
| SET 



done during terminal input and output. | SET 



BLIP 

RDYMSG 

INPUT 

OUTPUT 



Type 



CMS 

CMS 
CMS 

CMS 
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Function 



Create a source program file from the 
terminal. 

Invoke the System Assembler to assemble 
a source program. 

Invoke the BASIC Compiler. 



Command 



EDIT 



ASSEMBLE 



BASIC 



Type 



I 

CMS | 

I 
I 

CMS | 
I 
I 

CMS | 



o 
ft- 

O 



O 
Hi 



n 
o 



Create or list macro libraries to be 
used during assemblies or compilations. 

Create or list subroutine libraries. 

Specify macro libraries to be searched 
during assemblies or compilations. 

Specify subroutine libraries to be 
searched during LOAD and INCLUDE 
function. 

Bring object code into storage. 



Create a MODULE (core— image) file. 
Print a storage map of a MODULE file. 



MACLIB 




CMS 


TXTLIB 




CMS 


GLOBAL 


MACLIB 


CHS 


GLOBAL 


TXTLIB 


CMS 



LOAD 
INCLUDE 



GENMOD 
MODMAP 



CMS 

CMS 



CMS 
CMS 
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Function 



Bring MODULE files into storage. 

Build auxiliary module directories. 

Begin execution of programs which were 
previously loaded into main storage. 

Simulate OS Data Definition (DD) JCL 
cards during program execution. 

Load and execute object (TEXT) files. 

Compile, load, and execute source files. 

Load and execute core—image (MODULE) files 



| Command 


Type | 


| LOADMOD 




CMS | 


| GENDIRT 




CMS | 


| START 




CMS | 


| FILEDEF 




CMS | 


| RUN 




CMS | 


| RUN 




CMS | 


| RUN 




CMS | 
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Function 



Stop execution at a specified virtual 
machine location. 

Resume execution of a stopped 
virtual machine. 

Display virtual storage r registers r 
PSW r etc. 



Print the contents of virtual storage 
locations on the spooled printer. 



| Command 


Type | 


| ADSTOP 




CP | 


| DEBUG 


BREAK 


CMS | 


| BEGIN 




CP | 


| DEBUG 


GO 


CMS | 


| DISPLAY 




CP | 


| DEBUG 


GPR 


CMS | 


| DEBUG 


PSW 


CMS | 


| DEBUG 


X 


CMS | 


| DUMP 




CMS | 


| DEBUG 


DUMP 


CMS | 
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Function 



Change the contents of registers and 
storage locations. 



Trace virtual machine SVC calls. 

Trace virtual machine instructions , I/O 
operations, SVC calls, etc. 

Convert system ABEND clumps to printed 
output. 



Command 



STORE 
DEBUG 
DEBUG 

SVCTRACE 

TRACE 

VDUMP 



STORE 
SET 



| Type 

CP 

CHS 
CHS 

CHS 

CP 



CHS 



Figure 4. Commands to Test and Debug a Program (Part 2 of 2) 



o 

hh 



O 
O 



Function 



Create a file from terminal input. 
Create a file from card input. 

Verify the existence of a file on disk. 
Erase a file (or files) from disk. 



List names of files on disk and their 
attributes. 

Type the contents of a file at the 
terminal. 



Command 



EDIT 



READCARD 
DISK 



STATE 



ERASE 
ACCESS 



LISTFILE 



TYPE 



LOAD 



ERASE 



Type 



CMS 


CMS 


CMS 



CMS 



CMS 
CMS 



CMS 



CMS 
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Print the contents of a file or a member 
of a library on a spooled printer. 

Punch the contents of a disk file on a 
spooled punch. 

Sort the records of a file into ascending 
order based on specified sort fields. 

Copy one disk file to another disk file. 



Combine several files into one file. 

Copy data from one device type to 
another device type- 
Change the name of a CMS file. 



Command 



PRINT 

PUNCH 
DISK 

SORT 

MOVEFILE 
COPYFILE 

COPYFILE 

MOVEFILE 

RENAME 



DUMP 



| Type 
CMS 

CMS 

CMS 

CMS 

CMS 
CMS 

CMS 

CMS 

CMS 
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Compress a file by encoding multiple 
contiguous occurrences of a single 
character. 

Rearrange the contents of records in a 
disk file. 

Perform character translations on 
specified characters in a disk file. 

Append one file to the end of another 
file. 

Remove trailing blanks from records in a 
file. 

Compare the contents of two disk files. 



COPYFILE 



COPYFILE 



COPYFILE 



COPYFILE 



COPYFILE 



COMPARE 



PACK 



TRANS 



APPEND 



TRUNC 



CMS 



CMS 



CMS 



CMS 



CMS 



CMS 
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3 



\ 



O 

c 
p- 
o 

en 



hh 
O 

a 
in 

(0 

n 
en 



Change records in a file based on 
record sequence numbers. 

Change attributes of a spooled file. 

Terminate spooling operations on a 
virtual unit record device. 
Load the virtual forms control buffer 
(FCB) , 

Indicate order of processing for spooled 
files. 

Remove spooled files from the system. 

Print documents according to to control 
words in the document file. 



Command 



UPDATE 

CHANGE 

CLOSE 

LOADVFCB 

ORDER 

PURGE 
SCRIPT 



| Type 
CMS 

CP 
CP 
CP 

CP 

CP 
CMS 
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Change options in effect for spooling 
operations- 
Route spooled input files to another 
user. 

Copy data from disk to tape. 

Copy data from tape to disk. 

Convert OS partitioned data set (PDS) 
files or card^image files on tape to CMS 
format on disk 



| SPOOL 




CP | 


| TRANSFER 




CP | 


| TAPE 


DUMP 


CMS | 


| TAPE 


LOAD 


CMS | 


| TAPPDS 




CMS | 
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Function 



Logically connect a disk to a virtual 
machine. 

Logically disconnect a device from a 
virtual machine. 

Hake files on a disk available to a user. 

Remove accessibility to files. 

Dump a disk to tape, and restore disk 
from tape. 

Format disk space in CMS format. 

Format real or virtual disk volumes. 



Command 



LINK 

DETACH 

ACCESS 

RELEASE 

DDR 
DDR 

FORMAT 

MINIDASD 



DUMP 
RESTORE 



| Type 
CP 

CP 

CMS 

CMS 

CMS 
CMS 

CMS 

CMS 
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Function 



Load a virtual machine operating system. 

Alter the virtual machine configuration. 

Disconnect user terminal from VH/370. 

Enter control program commands from a 
CMS virtual machine. 

Communicate with other virtual machine 
users or with the system operator. 

Simulate an external interrupt for a 
virtual machine. 

Simulate a not ready 1 for a virtual device 



Command 



IPL 

DEFINE 
DISCONN 
CP 

MSG 

EXTERNAL 

NOTREADY 



| Type 
CP 
CP 
CP 
CMS 

CP 

CP 

CP 



_» Figure 7. Commands for Virtual Machine Control (Part 1 of 2) 



Function 
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Simulate functions of buttons on the 
main computer console. 

Place virtual machine console in dormant 
state with keyboard locked. 

Perform tape rewind action- 



Establish User Directory Entries, 

Simulate device end interrupt to a 
virtual machine device- 
Reset virtual device's pending interrupts 



Command 



SYSTEM 

SLEEP 

REWIND 
TAPE 

DIRECT 

READY 

RESET 



REW 



| Type 
CP 

CP 

CP 
CMS 

CMS 

CP 

CP 
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Define means of entering CMS command 
CMS command names 



Indicate if I/O is to be done as 
specified by the virtual machine with no 
CCW translation by CP. 

Control timer updating. 

Change or set the number of loader 
tables for a CMS virtual machine. 

Release pages of storage after certain 
CMS commands execute. 

Get virtual machine status information. 



SYNONYM 




CMS 


SET 


ABBREV 


CMS 


SET 


IMPEX 


CMS 


SET 


IMPCP 


CMS 


SET 


NOTRANS 


CP 



SET 


TIMER 


SET 


LDRTBIS 


SET 


RELPAGE 



QUERY 



CP 
CMS 

CMS 

CP 
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| Function 


Command 


Type 


| Create accounting records for logged on 


ACNT 


CP 


| users and reset accounting data. 






| Logically connect or dedicate devices 


ATTACH 


CP 


| to a virtual machine or to CP. 






| Logically disconnect devices from 


DETACH 


CP 


| a virtual machine or from CP, 






| Disable communication lines. 


DISABLE 


CP 


| Enable communication lines. 


ENABLE 


CP 


| Force a specific user to log out from CP, 


FORCE 


CP 


j Terminate active channel CP program on a 


HALT 


CP 


| specific device. 
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Control paging activity. 



Reguest information about real and 
virtual machine characteristics. 

Establish system parameters. 

Terminate functions and checkpoint 
system. 

Transmit high priority messages to users. 



LOCK 
UNLOCK 

QUERY 



SET 
SHUTDOWN 

HNG 



CP 
CP 

CP 

CP 
CP 

CP 
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Restart or reposition the current output 
of an output spooling device. 

Change attributes of a closed spool file. 

Halt operations of specified spooling 
devices following completion of current 
activity. 

Cancel current output on a real unit 
record device. 

Cancel spool HOLD status. 

Defer spooled output of a particular 
user. 

Load printer UCS or FCB buffer. 



Command 



BACKSPAC 

CHANGE 
DRAIN 

FLUSH 

FREE 
HOLD 

LOADBUF 



| Type 
CP 

CP 
CP 

CP 

CP 
CP 

CP 



c 

O 
rt- 
H- 
O 
3 
W 



2 



O 
O 

3 
3 
Q> 



Cause spooled files to be processed in a 
specific order. 

Remove closed spool files from the 
system. 

Request information about spool files. 

Repeat printing or punching of current 
file on a specific output device. 

Force a printer to single space output. 

Start spooling device after draining or 
changing output class. 

Direct spooled files to a user's card 
reader. 



ORDER 

PURGE 

QUERY 
REPEAT 

SPACE 
START 

TRANSFER 



CP 

CP 

CP 
CP 

CP 
CP 

CP 



-J Figure 9. Commands For Spooling Control 



Function 



o 

a 

O 



Pi 



Display real storage at terminal. 

Dump real storage to virtual spooled 
printer. 

Find locations of control blocks. 

Save virtual machine storage space 
on disk. 

Perform intensive recording of device 
activity information. 



| Command 


Type | 


| DCP 




CP | 


| DMCP 




CP | 


| LOCATE 




CP | 


| SAVESYS 




CP | 


| SET 


RECORD 


CP | 



o 

a 
to 
n> 
n 
to 



Set the error recording mode for soft 
machine checks. 

Dump error information which has been 
recorded by error recording routines. 



SET 



CPEREP 



MODE 



CP 



CMS 



Figure 10. Commands for System and Hardware Analysis 
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SUMMARY OF VM /370 COMMANDS 



The following is a listing of all the CP 
and CMS commands. The CMS DEBUG 
subcommands, EXEC control statements and 
built-in functions,, and EDIT commands are 
described first. Then, a reference card 
lists the CP and CMS commands; a brief 
description precedes a syntactic 
representation of each command. 

The commands and subcommands are shown in 
upper and lower case; the upper case 
represents the minimum truncation of the 
command that the system accepts. Where 
options are given, the underscore indicates 
the default option. Options in brackets may 
be omitted. See the IBM Virtual Machine 
Facility/370: Command Language User's 
Guide, Order No. GC20-1804, for an 
explanation of other notational 
conventions. 
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to 



DEBUG Command Description 



Command/Subcommand Format 



o 

PS- 



DEBUG CMS 

1 Enters the DEBUG environment to 

perform program analysis and 

repair. 

Stops program execution. 

Types the Channel Address Word. 

Types the Channel Status Word. 

Assigns a symbolic name to a 
specific storage address. 

Dumps the contents of storage 
locations to the virtual 
printer. 

Exits from the DEBUG 
environment. 

Types the contents of the 
specified general registers. 

Returns to CMS environment. 



DEBUG 

DEBUG environment entered; the formats of 
each DEBUG subcommand are as follows: 



BReak { symbol | hexloc } 

CAW 

CSW 

DEFine symbol hexloc 



DUmp 



m 

f symboll 1 f symbol2 
L hexloc J hexloc2 
L * 

GO f symbol "1 
L hexloc J 

GPR regl [reg2] 
HX 



[ident] 



n 
o 



1 Sets a base address, 
I 


ORigin 


{ symbol | hexloc } | 


Types the contents of the eld 
| Program Status Word, 
1 


PSW 


1 


1 Returns to CMS environment. 


RETurn 




Changes the contents of the 
j specified register or location. 


SET ( 


CAW hexinfo ) 

CSW hexinfo [hexinfo J ( | 

PSW hexinfo [hexinfo;] ( 

GPR reg hexinfo [hexinfo] J 


Stores information in the 
j specified virtual location. 


STore 


\ symbol 1 hexinfo | 
\ hexloc S 


Indicates means of handling 

i i/o. 


TIN { 


CMS|DEB } 


1 Examines virtual storage 

| locations, 1 


X \ symbol { \ n 1 
I hexloc \ [ J\ J 



EXEC Command Description 



Control Statements and Built— in Functions 



a: 






fl> 

H) 
O 
H 

a 
en 
fl> 
r-i 
w 



EXEC 

Tnvokes EXEC files. 



CMS EXec fn [args...] 

j The formats of the EXEC control statements 
and built— in functions are as follows: 



Defines or redefines arguments. 

Punches the following lines 
into cards. 

Stacks the following lines into! 
the terminal input Buffer. 

Types the following lines at 
the terminal. 

Combines tokenl and token2. 

Provides a branching address 
for EXEC branch statements. 

Supplies the parameters for the] 
execution phase of the EXEC 
file. 



I 



SARGS [argl [ arg2 
8BEGPUNCH [ALL] 



-.]] 



SBEGSTACK 
SBEGTYPE [ALL] 



1 CALL] 



8C0NCAT tokl { tok2 ... } 
&CONTINUE 



SCONTROL 



OFF 
ERROR 
CMS 
ALL 



TTIME 1 r PACK I 
[NOTIMEJ [NOPACKj 



s 
a 
o> 

o 

hh 



V 



n 
o 

S 
B 
0> 

3 



Allows the defined token to be 
known from this point on by its 
composition, that is r numeric 
or character data, 

END statement for action 
started by 8BEGPUNCH, 8BEGSTACK 
or 8BEGTYPE. 

Provides error return 
processing. 

Exits from the EXEC file with 
a given return code. 

Transfers control to a defined 
location. 



Allows statement execution if 
the comparison is satisfied. 



&DATATYPE tok 



SEND 



&ERROR action 



8EXIT [return-code] 



[' 



&GOTO (TOP 

•hi 



■> line-number 
/label 



8IF 



tokl / 


\NE 


8$ [ 


8* J 


;lt 




^LE 




Vgt 




(ge 



tok2 ) executable 
8$ [ statement 
8* i 



EXEC Command Description 



Control Statements and Built— in Functions 



\ 



o 



O 
PS* 

a 

p 

Pi 



Indicates the number of non- I 
blank characters in the | 
following token. 

Allows the use of the literal I 
value of the token. 

Repetitively executes a | 
sequence of statements, ] 

Punches a card with the defined! 
tokens, j 

Reads the next line (or lines) 
from the terminal. 



Skips subsequent statements. 

Types blank lines at the 
terminal. 



8LENGTH tok 



&LITERAL tok 

SLOOP 

&PUNCH tokl [tok2 ... ] 



I label } (condition) I 



&READ 



SSKIP 



&SPACE 



n 

ARGS 

VARS [varl [var2 ... ]] 

A J 



[I] 

m 



o 

Hi 

< 

£3 
\ 



Places a line of tokens in the 
console stack. 


8STACK TLIFOl [tokl [tok2 .. 
I FIFO | 


• ] I 


Extracts the desired string 
from the given token. 


8SUBSTR tok i [ j] 




Types time information on the 
terminal. 


STIME [ON 1 TrESEt] 
JOFFJ [TYPE J 




Prints the tokens at the 
terminal. 


8TYPE tokl [tok2 ... ] 





o 
o 

a 
a 

en 



9DIT Command Description 



Command/Subcommand Format 



o 



o 
c 



IEDIT 



'"Provides access to the EDIT 
environment. 

Scans records, altering the 
specified character. 

Points to the last line of the 
file. 

Translates to uppercase. 
Changes stringl to string2. 

Enters CMS subset command mode- 
Deletes n lines or to EOF. 

Points to the nth line down 
from the current line. 



CMS Edit fn ft [ f m ] [ (LRECL nn ) ] 

The EDIT subcommands are as follows: 



Alter j charl i 
Jhex1 ! 



i char2 j 
1 hex2 ) 



{lb}} 



Bottom 

CASE j" U 1 

Change /string1/string2 [/] 



[1 \m\ 



CMS 

DELete [n|J|*] 

DOwn [nil ] 



o 

l-h 



3 



O 

o 






Saves the file edited on disk 
and returns to CHS, 


FILE fn [ft [fm 


]]] 1 


Searches the file for the 
given line. 


Find [line] 




Resets or types the filemode. 


FHode [fm] 




Resets or types the filename. 


FName [ f n ] 




Inserts some or all of the 
given file- 


Getfile f n 1" f t f 


f ! [ I [ * ] ] ] ] j 


Expands text into line images 
or displays current settings. 


IMAGE ( ON ) 
JOFF f 
I CANON \ 


J 


Inserts 'line' in the file or 
enters Input mode. 


Input [line] 


J 


Sets or types line numbering. 


LINEmode [ Left | 


Right | OFF ] | 


Scans the file for the first 
occurrence of 'string'. 


Locate /string[/" 


1 


Enters LONG error message mode. 


LONG 





00 

3 



3! 



(0 



O 

n 

a 
w 

CD 
»1 
W 



EDIT Command Description 


Command/Subcommand 


Format 


Points to the nth line down 
from the current line. 


Next [nQ] 




Replaces all or part of the 
current line. 


Overlay line 


i 


Saves current mode settings. 


PREserve 


1 
i 


Sets the line increment. 


PROMPT [incr] 


1 


Terminates the EDIT session. 


QUIT 




Sets or displays record format. 


RECfm [F|V] 


' 


Executes the following OVERLAY 
request n times. 


REPEAT [n|H*] 




Replaces the current line with 
•line' or deletes the line and 
enters Input mode. 


Replace [line] 




Restores mode settings. 


REStore 




Returns to EDIT environment. 


RETURN 





o 
o 



Stacks (LIFO) the last EDIT 
subcommand.. 

Saves the file on disk. 

Turns serialization on or off 
in columns 73—80. 



Enters SHORT error message mode 

Stacks n lines in the terminal 
input buffer. 

Sets the given tabs 

Points to the beginning of the 
file. 

Sets or displays the column of 
truncation. 

Types the specified number of 
lines beginning with the 
current line. 



S REUSE I [edit subcommand] 

SAVE [fn [ft [fm ]]] 
SERial C OFF ) 

< seq liner I } 

( all l ~ J ; 

SHORT 

STACK [n|_1|edit subcommand] 

TAESet tabs... 
TOP 



TRUNC [ n|*] 
Type 



m [ n 
* * 



EDIT Command Description 



Command/Subcommand Format 



O 



Points to the line n lines 
above the current line. 

Sets, displays, or resets 
verify mode. 

Assigns to X or Y the given 
EDIT subcommand. 

Sets or displays the columns 
to be edited. 



Types the last EDIT subcommand. 

Locates the line. 

Duplicates the current line. 

Moves n lines up or down m 
lines. 



Up [n|J] 

Verify fON^j [ n ] 

X 
Y 



LOFF J 
[edit subcommand | m |J] 



Zone 



nnnnn 

$DUP 

$MOVE 



MC 



[ text ] 

Clin] 

n {[UP m|DOWN m]|[TO label]} 



Trirr^Along This Line 
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Command Description 



Command Format 



ACCESS CMS 

"Defines direct access space to a 
CHS virtual machine and relates 
it to a logical directory. 



ACNT CP Class A 

Creates accounting records. 

ADSTOP CP Class G 

Halts the virtual machined 
execution. 



ACcess / ecu mode [/ext [ f n [ft [fm ]]]] 

) [(NOPROF) | (ERASE) ] 

) V (NODISK) J 

ACNT }userid1 userid2 . . .( 
{all \ 



ADSTOP 



Jhexloc/ 
lOFF \ 



ASSEMBLE CMS 

Invoices the System Assembler. 



PRINT 
NOPRINT 
DISK • 



ATTACH CP Class B 

"5ff aches a real device to a 
specified user or to the system. 



ATTACH CHANNEL 



CP Class B 



~TEtac"Ees a channel to a 
designated user. 

BACKSPAC CP Class D 

Restarts a current spool file. 



BASIC CMS 

Invokes the VM/370 BASIC Language 
Processor. 

BEGIN CP Class G 

Starts the execution of a virtual 
machine. 

CHANGE CP Classes D r G 

"STEers the attributes of a closed 
spool file. 



Assemble fn [ (options...) ] 

options : 

[N0XREF1 TRENT 1 fDECK ] [NOLOAD] 
[XREF J L NO RE NT J | NODECK | 1 LOAD J 

[DOS] ("TEST 1 [LINECNT nn 1 f NOTERM ] 
LOS J I NOTEST 1 [LINECNT 5 5 J | TERM J 

[NONUM] [STMT 1 [ N0LIST1 
L NUM J 1 NOSTMT | | LIST J 

ATTach raddr [To] Juserid [ As 1 vaddr [R[/0]]/ 
/SYSTEM [as J volid f 

ATTach CHANnel c [To] userid 



Printer Format 



File 



pages 



TTAcKsp ac~ r a d dr 

BAsic f n [ (LONG) ] 

Begin [ hexloc ] 

CHange [userid] 
[SYSTEM ] 
Reader 



Printer 
I PUnch 



Punch Format 
"BTcTspac racldr [File] 



Class a 
spoolid 
ALL 

,CLass a) 
spoolidt 
ALL 



CLass b 



CLass b J 

COpy nn f 
r HOldlNOHoldY 
Dlst distcodeX 



e jfn [ft]| j 



CLOSE CP Class G 

Terminates spooling operations 
on a virtual reader, printer, or 
punch. 



COMPARE CMS 

Compares all or part of records 
in two existing files. 



CLose 



^Reader 
Lvaddr 

/Printer 

\PUnch 

ivaddr 



[NAm 

[ ) dshame 

[ HOld|NOHold] 

[ PUrge 1? 

I fHOld 1 ["st distcode] | ( 

I L N0Hold J [ Nftrae ffSnUHIP 



) 



COPYFILE 

"Copxes files according to 
operand specifications. 



CMS 



COMpare fileidl fileid2 [ (COL mm-nn) ] 

COPYfile fileidl [fileid2...J 

[fileido] [ (options) ] 

options: 

("Type I [OLDDate] [ RECf m F] rNOPrompt] [TRAns] 
I NOType j I NEWDate I [RECfm VJ L£§51£i J 

f UPcase 1 [From recno ] f 
[LOWcaseJ [ FRLabel xxxxxxxxj [ 

TTRUnc ] [PAck 1 [ EBcdic ] 
I NOTRunc 1 [ UNPack J 



REPlace 
OVly 
APpend 
NEWFile 



Fill c 
Fill hh 
Fill 40 



FOR recno 1 
TOLabel xxxxxxxxj 



COUPLE CP Class G 

Connects virtual channel to 
channel adapters. 

CP CMS 

Permits entry of CP console func- 
tions from the CMS environment. 

DCP CP Class E 

"Displays real processor storage 
on the terminal. 

DDR CMS 

"Dumps, restores, or copies data 
between DASD devices and tape 
devices. 

DEBUG CMS 

"Enters the DEBUG environment to 
perform program analysis and 
repair. 

DEFINE CP Class G 

"Reconfigures the user's virtual 
machine. 



[ LRecl nn ] f SPecs ] 
[ NOSPecs J 

COUPLE vaddrl [To] userid vaddr2 



CP [ line ] 



hexlod 
Lhexloc 
Thexloc 



DDR [fn ft [fm] ] 



DEBUG 



1 [ in mi loc2 ] ]! 



DEFine 



/Reader 

Printer 

PUnch 

CONsole 

CTCA 
\TIMer 
\1403 

3211 

/Line 



[As] vaddr 



[As] vaddr 



[iBMril ]\ 
ITELtE^L 



DETACH CP Class B 

"""Reloves a real device from the 
system or from a specific user. 

DETACH CP Class G 

TJefaches a virtual device from 
the virtual machine. 

DETACH CHANNEL CP Class B 

"Removes "Hie specified channel and 
all its related devices from 
the specified user. 

DIAL CP Class ALL 

"Attaches a terminal device to a 
multiple access system. 

DISABLE CP Classes A f B 

TnTTTbits the use of communication 
lines. 

DISCONN CP Class ALL 

"Disconnects the terminal from 
virtual machine operation. 

DISK CMS 

Bumps and restores disk files. 

DISPLAY CP Class G 

"Displays storage locations and 
registers within the virtual 
machine. 



ivaddrl [ As] vaddr2 

'T2314 

T2319 [As] vaddr [CYL] nnn 
T3330 L J 

T2305 

^STORage [As] nnnnK 

DETach raddr [From] juseridf 
?SYSTEM( 



DETach vaddr 



DETach CHANnel c [From] userid 



Dial userid [vaddr] 



DISAble (raddr.. 4 
/ALL S 



DISConn [ HOld ] 



DISK 
Display 



(DUMP fn ft [fm]i 

Iload f 



/ hexlod 
Lhexlod 
Thexlocl 

\Khexloc1 

/Gregl r 
\Yreg1 I 
Jxregl | 

Psw 

CAW 

\csw 



f H 



[hexloc2] 
I END J 



reg2 






DMCP 



CP Class E 



""Dumps any area of System/370 real 
storage to a spool device. 



DRAIN CP Class D 

^TEops spooling activity on the 
specific device after the 
current file is finished 
spooling. 

DUMP CP Class G 

Tumps virtual machine registers 
and storage to the virtual 
printer. 

ECHO CP Class G 

"Returns data directly to the 
terminal. 



DMCP 



(hexlod 
^Lhexlod 
Thexlod 



fhexloc2] I 
1MB jj 



[dumpid ] 



DRain 



DUmp 



j Reader 
j Printer 
PUnch 
I raddr. . « 
[ILL 

ihexlod 

Lhexlod 

Thexlod 



\-| I hexloc2| I 
U\ [IND j 



[ dumpid ] 



ECho 



[r] 



EDIT CMS 

Provides access to the EDIT 
environment. 

ENABLE CP Classes A,B 

Tcfivates communication lines. 

ERASE CMS 

"Deletes files from a user's disk 



Edit fn ft [fm] [ (LRECL nn) ] 



jraddr. « 
JALL 



EXEC 

Invokes EXEC files. 



CMS 



ENable 

ERASE fn ft [fm] f (Type) ] 
L (NoixpeJ J 

EXec fn [ args. . . ] 



EXTERNAL CP Class G 

""CreaTes an external interrupt 

condition on the virtual machine. 

FILEDEF CMS 

~~ Simulates OS JCL data definition 
(DD) statements. 



EXTernal [code] 



Flledef (ddname 
nn j 



^Terminal [ (optionA optionD]^ 

1 Printer 
PUnch 
' Reader 

/DISK [fn ft.[ fm] 



TAPi 

DUMMY 

\CLEAR 



[optionB optionD] 
[optic - " --^.---^t 



LonC optionD] 



FLUSH CP Class D 

Halts and immediately purges or 
holds the current spool file. 

FORCE CP Class A 

"Forces logout of the named user. 

FORMAT CMS 

"Formats a disk for use by CMS. 

FREE CP Class D 

"Releases previously held user 
spool files. 

GENDIRT CMS 

""Creates auxiliary module 
directories. 

GENMOD CMS 

"Generates absolute nonrelocatable 
files (MODULE files) . 



optionA: [UPCASE |L0WCASE ] 

optionB: [ KEYLEN n] [EXTENT {n|50}] 

[LIMCT n] [OPTCD {A|E|F|R}] 

[DISP MOD] 
optionC: [7TRACK| 9TRACK] [ TRTCH { | 0C | 0T | E | ET } ] 

[DEN { 200 I 556 | 800| 1600}] 
optionD: [ PERM ] [CHANGE | NOCHANGE ] 

[RECFM{F|FB| V|VB|U| VS| VBS|FS|FBS| A|M}] 

[LRECL n] [{ BLOCK | BLKSIZE } n] 
FLush raddr [ALL] [HOld] 

FORCE userid [HOld] 

FORMAT ecu mode [nocyl][ (Recomp) | (LABEL) ] 



FRee userid 

GENDIRT directory— name 



Printer 

PUnch 

ALL 



GLOEAL CMS 

"Defines CMS libraries to be 
searched for macros and 
subroutines. 

HALT CP Class A 

"STiops any active channel program 
on the real device specified. 

HO CMS Immediate Command 

Halts the current CMS tracing 
operation. 

HOLD CP Class D 

HDefers processing of specified 
spool output. 

HT CMS Immediate Command 

Halts typing at the terminal. 

HX CMS Immediate Command 

Halts the execution of the 
current CMS operation. 

INCLUDE CMS 

"Brings additional TEXT files into 
storage. 



IPL CP Class G 

Initiates a program load on the 
virtual machine. 

LINK CP Class G 

"Permits one user to access mini— 



Genmod fn [ft [fm]] [(options...)] 
options: 

[NOMAP] TSTR ] [FROM entl] [TO entl ] [SYSTEM] 
I MAP j [NOSTRJ 

Global IMACLIB/ [libname...] 

/txtlib! 



HALT raddr 



HO 



HOld userid 



HT 



HX 



INclude fn. 
options : 



Printer 

PUnch 

ALL 



[ (options. . .) ] 



disks belonging to another user. 

LISTFILE CMS 

Iisfs~information about CMS files 



LOAD CMS 

"Brings TEXT files into storage 
and establishes linkages. 



LOADBUF CP Class D 

loacls UCS buffer on the real 
printer device. 

LOADMOD CMS 

Irings a single MODULE file into 
storage. 

LOADVFCB CP Class G 

loans a forms control image for a 
virtual 3211 printer. 

LOCATE CP Class E 

"Provides the addresses of CP 
control blocks related to a 
specified user, virtual device, 
or real device. 

LOCK CP Class A 

locks specified pages in 
processor storage. 

LOGIN CP Class ALL 

Tnitiates all virtual machine 
operation. 

LOGOUT CP Class ALL 

Terminates a terminal session. 

MACLIB CMS 

Fgrrorms maintenance on macro 
libraries. 



{"CLEAR 1 [RESET entry] [NOMAP] [ NOINV ] fNOREP] 
[ NOCLEAR I [RESET * J [MAP J L IN V J [REP J 

[TYPE I [NOAUTO] [ NOLIBE 1 [ORIGIN hexloc] 
1 NOTYPE ) j AUTO J | L IBE J 

[ START] [SAME] 

Ipl jvaddr [cyl-no] [Clear ]( 
/system— name | NOCLear j) 

LINK [To] userid vaddrl [As] vaddr2 
[mode] [[PASS= ] password] 

Listfile [[fn [ft [fm]]] [(options)] 
options: 



[ Header | NOHeader ] [ EXec | APpend ] 

[ FName| FTypel FMode| FOrmat | ALloc | Date | Label ] 

LOAD fn ... [ (options) ] 
options: 



[CLEAR ] [RESET entry] [NOMAP] [NOINV] [NOREP] 
1 NOCLEAR j [RESET * J { MAP J [ IN V J I REP J 

[TYPE I [NOAUTO] [NOLIBE] T ORIGIN hexloc 1 
1 NOTYPE I \ AUTO J | LIBE J [ORIGIN TRANS J 

[START] 

LOADBUF raddr \UCS name [Fold] [Ver]f 
iFCB name ) 

LOADMod fn [ft f m ] 



LOADFVCB vaddr FCB name 



LOCate Juserid [vaddr]/ 
jraddr 1 



LOCK userid fpage lpage 

Login userid [password] [Mask] [Noipl] 



LOGout [HOld] 
LOGoff 

MAClib /GEN 

ADD libname fn1 [fn2...] 
REP 
\DEL libname 

macname[ macname2. . .macnameN ~\[ 
\C0MP libname 

(MAP libname [[TERM 



| (TERM) | 

j (PRINT) I 

(DISK) 



I ) 



Command Description 



MODMAP 



-h 



Command Format 



""T^pes a MODULE file load map. 



CHS jHODmap fn 



MOVEFILE CMS 

Moves data from one device to 
another device. 

MSG CP Class B 

Sends text messages to other 
users or the system operator. 



MSG CP Class ALL 

Bends text messages to other 
users or the system operator. 

NOTREADY CP Class G 

"Simulates the loss of read^ 



MOVEfile 



T input- 



— ddname 
NMOVE 



f output-ddnamel 1 
I OUTMOVE j J 



Msg 



status on a virtual spooled unit 
record device. 

ORDER CP Classes D f G 

"Provides a technique for ordering 
closed spool files. 

PRINT CMS 

Directs a specified spool file 
to the virtual printer. 



PUNCH CMS 

"Directs a specified spool file to 
the virtual punch. 

PURGE CP Classes D,G 

"Deletes a spooled file before 
reading, printing, or punching 
occurs. 



&UERY CP Classes A, I 

"Provides the paging activity 



index or specified user priority. 

.QUERY CP Class B 

Provides the current status of 
all system devices. 



&UERY CP Class D 

Provides data on spooling 
operations. 



OJJERY CP Class G 

Provides the virtual machine user 
with the current status of his 
virtual machine, spooling devices 
and spool files. 



ALL \ 
userid ( 

operator) 

juserid / 
) operators 



msg— text 



Msg 

NOTReady vaddr 



nsg-text 



ORDer 



[userid! (Read 
SYSTEMj fcrin 
-» (PUnc 



er / jCLass d CLass c2.. 
ter> Ispoolidl spoolid2.. 
h 



•\ I 



PRint fn ft [fm] [ (options) ] 
options: 



TCC 1 r M -EMbor * 1 rrDrasc^ r-^vi 

f NOCC [ [ »s::ber na-ej ~ " "' ~ ' ' 

PUnch fn ft [fm] [(fNOHeaderl fMEMber * ]) ] 

L L Header J [MEMBER name J J 

PURge Tuserid] 
SYSTEM J 



(Reader 
<>Printer 
^PUnch 
VALL 



ICLass c1 CLass c2 ...> l) 
/spoolidl spoolid2 ...J Is 



Query 
Query 



&UERY CP Class ALL 

Provides the remaining portion of 
the log message, and the names 
and real address of other logged 
on users. 

&UERY CMS 

PeTmits the user to obtain 
specified information about his 
virtual machined CMS functions. 
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Printer 
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Time 
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[Virtual] 



Links 

Reader 

Printer 
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Query 
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(LOGmsg 

) Names 

) Users [userid] 

luserid 



BLIP 
RDYMSG 
LDRTBLS 
RELPAGE 
IMPCP 
IMPEX 
ABBREV 
REDTYPE 
| PROTECT 
SEARCH 

DISK [mode] 

i L* J 



READCARD CMS 

"Reacts data from the spooled card 
input device. 



READY CP Class G 

HaTces a device end interrupt 

Sending for the specified virtual 
evice. 

REL EASE CMS 

"Hakes a disk and its directory 
inaccessible to a virtual machine 



RENAME CMS 

Changes the name of a CMS file 
or files. 

REPEAT 



CP Class D 

Increases the copies of, or 
holds, an output spool file. 



RESET CP Class G 

"^Clears all pending interrupts and 

resets error conditions on the 

device specified. 

REWIND CP Class G 

"Rewinds a real tape drive. 

RT CMS Immediate Command 

Resumes terminal typing. 

RUN CMS 

Initiates a series of functions 
for a file. 

SAVESYS CP Class E 



Creates a copy of virtual machine 
contents as they currently exist. 



SET CP Class A 

Sets special CP preferred 
options. 



SET CP Class B 

"Establishes disposition for log 
messages and dumps. 



SET CP Class F 

Bets recording mode for a device, 

or enables/disables soft machine 
check interrupts. 



SET CP Class G 

Bets virtual machine options. 
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FILEDEF 
MACLIB 
TXTLIB 
LIBRARY 
INPUT 
\ OUTPUT 
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Rename fileidl fileidN [ (options) ] 

options: T TYPE 1 [NOUPdirtl 
1 NOTYPE I 1 UPdirt J 

REPeat raddr \ f" nn 1 

[nn] HOld 
RESET vaddr 



REWIND vaddr 

RT 

RUN fn [ft [fm]] [ (args...) ] 

SAVESYS system-name 



SET 
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^FAVored userid 
\REServe userid 



| OFFj/ 



\PAGing nn 
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SET 

"Sets or resets CMS virtual 
machine characteristics. 



CMS 



SHUTDOWN CP Class A 

Checkpoints and terminates the 
current VM/370 operation. 

SLEEP CP Class ALL 

Places the virtual machine in a 
dormant state with the terminal 
keyboard locked. 

SORT CMS 

Rearranges records within a file. 

SPACE CP Clas D 

Forces single spacing on the 
printer. 

SPOOL CP Class G 

"Changes spooling control options. 



START CP Class D 

"Restarts a drained device or 
changes its output spooling 
class. 



START CMS 

Begins program execution. 

STATE CMS 

"Verifies the existence of a file. 

STCP CP Class F 

liters real storage locations. 



STORE CP Class G 

"Alters virtual machine storage, 
PSW, and registers. 



SVCTRACE CMS 

"RecorcTs information about 
supervisor call instructions. 

SYNONYM CMS 

Specifies alternate names by 
which CMS commands may be 
invoked. 

SYSTEM CP Class G 

Simulates virtual machine console 
functions. 

TAP! CMS 

Performs tape to disk or disk to 
tape operations for CMS data 
sets. 



TAPPDS CMS 

Toefds an OS partitioned data set 
fPDS) file or card-image records 
from tape to disk. 



TERMINAL CP Class G 

Changes parameters for terminal 
operations. 



TRACE CP Class G 

Traces and records program 
execution. 
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functions: 





[BLIP string (count) ] 
BLIP ON 
BLIP OFF J 



[LDRTBLS nn] 

r RDYMSG SMSG 1 
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SHUTDOWN 
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PUT a 
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PROTECT 
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DUTPUT 
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SPace raddr 
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f Reader 

Printer 
I PUnch 
I ALL 



[raddr [CLass c] [NOSep]]., 
jentryj [args... ]*| 

STATE fn ft [ f m ] 



START 



STCP 



STore 



\ hexloc/ hexwdl [hexwd2...] ) 
/Lhexloc? I 

Shexloc hexdata » 

hexloc 

Lhexloc hexwdl [hexwd2...] 



Shexloc hexdata 

hexwdl [hexwd2. 



SVCTrace 



Greg 
Yreg 
Xreg 

Psw 

JON I 
JOFF$ 



[ hexwdl ] hexwd2 



SYNonym [[fn [ft [fm]]] [(options...)]] 

options: rNOSTDl [CLEAR] 
LSTI) J 



SYStem 



CLEAR 
RESET 
RESTART 



TAPE/ DUMP jfn| j f tl ["fml [ (optA optB optC) ] 
LOAD Tfn Tft ffm]]] [ (optA optB optC) ] 
SCAN Tfn ["ft I"! [(optA optB optC) ] 



I SKIP 



ll n i 



\P\ 



[ (optA optB optC) ] 



MODEset [ (optD) ] 
tapemd J" n 1 [ (optD) ] 

optA: TWTM ] optB: TNOPRint 
1 NOWTM 1 "~ " PRint 



opt D: 

-foN 200 
DEN 556 
DEN 800 
DEN 1600 



DISK 
TERM 
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EOF n 
EOT 
EOF 1 
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tapemd : [ BSF | BSR| ERG | FSF | FSR | REW | RUN | WTM ] 

TAPPDS [fn [ft [fm]]] [ (options...) ] 
options 

[NOPDS] TCOL1 ] TTAPnl [END ] fMAXTEN ] 
LPDS J I N0C0L1 I I TAP1 l I NOEND | f NOMAXTEN I 
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LINEDel 
| LINENd 
EScape 

Mask 

APL 

ATTn 



ON 

OFf 

char 



i 0N \ 
/OFFS 



TRace 



TRANSFER CP Classes D,G 

Transfers closed reader spool 
files. 

TXTLIB CMS 

Performs maintenance on a 
library of TEXT files (object 
modules) . 



TYPE CMS 

Types all or part of a file at a 
terminal. 



UNLOCK 

Releases storage. 



CP Class A 

CMS 



UPDATE 

EaTtes changes in a file as 
defined by control cards in a 
record file. 



VARY CP Class B 

"Varies the availability of a 
device. 



WNG CP Classes A,B 

Sends high priority messages. 



Permits comments. 
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SYSTEM 



ALL 
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J |CLass af 



DEL libn member ... 

MAP libn [ (TERM) | (PRINT) | (DISK) ]) 
Type fn ft [fm] | jredf | recN]] [(options)] 



Type fn 
options: 



COL xxx) 



Z 1 



i-'-^y j I [HEX] [ MEMber * 1 
jl£ecll J [MEMber name J 



UNLOCK Userid fpage lpage( 
1VIRT=REAL \ 

Update fn1[ft1[fm1[fn2[ft2[fm2]]]]] [(options)] 
options: 

[REP 1 TN0SEQ8 1 [INC 1 [ CTL 1 f STK 1 
[NO REP] [SEOJ J [NOINCJ 1 NOCTL | 1 NOSTK 1 

RM1 [PRINT] 
J [DISK j 

ONLINE I 
OFflineS 

Wng (userid ) msg— text 



NOTEE 
TERM 



VARY DEV raddr 



( userid 
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any— comment 
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